package com.xl.qa.service;

import com.xl.basic.entity.Result;
import com.xl.basic.entity.UserInfo;
import com.xl.qa.entity.param.AddIndexBannerParam;
import com.xl.qa.entity.param.QueryIndexBannerParam;
import com.xl.qa.entity.param.UpdIndexBannerParam;
import com.xl.dao.domain.XlIndexBanner;
import lombok.NonNull;

import java.util.List;

/**
 * @author 钟勇
 * Create in 2024/2/4 15:10
 */
public interface IndexBannerService {
    /**
     * 新增首页广告
     *
     * @param param    param
     * @param operator 操作人
     * @return res
     */
    Result<Integer> addIndexBanner(@NonNull AddIndexBannerParam param, UserInfo operator);

    /**
     * 编辑首页广告
     *
     * @param param    param
     * @param operator 操作人
     * @return res
     */
    Result<Object> updIndexBanner(@NonNull UpdIndexBannerParam param, UserInfo operator);

    /**
     * 删除广告
     *
     * @param bannerId 广告ID
     * @param operator 操作人
     * @return res
     */
    Result<Object> delIndexBanner(@NonNull Integer bannerId, UserInfo operator);

    /**
     * 获取广告页明细
     * @param bannerId 广告ID
     * @return res
     */
    Result<XlIndexBanner> getIndexBannerDetails(@NonNull Integer bannerId);

    /**
     * 获取首页广告列表
     * @param param param
     * @return list
     */
    Result<List<XlIndexBanner>> queryIndexBannerList(@NonNull QueryIndexBannerParam param);
}
